home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / ls_4_7LJR.readme < prev    next >
Text File  |  1996-09-26  |  8KB  |  216 lines
  1. Short: LS 4.7LJR unix style directory lister
  2. Type: os20
  3.  
  4.                                  LS 4.7ljr
  5.                      UPDATE TO 4.5 USER DOCUMENTATION
  6.                   AND BUG/FEATURE FIXES SINCE 4.5 RELEASE
  7.                          Fri Nov 20 01:07:41 1992
  8.  
  9. The ls.doc file has only been halfway updated to show all the changes
  10. since the 4.5ljr release.  Please read this README file for full
  11. details.  I've dragged my feet for a month now with regards to getting
  12. the doc file updated.  It just isn't going to happen in the near future
  13. and thus I thought it better to release this now as is.
  14.  
  15. Thanks to Dan B. and Chris W. for their recent help in getting some
  16. important bug and feature fixes into ls.  Many others have helped
  17. since 4.5 by reporting problems and oddness when ls is used under
  18. 3rd party shells. [BTW, ls was operating correctly, but I have added
  19. a patch to ls that flushes Output() to work around limitations in
  20. some user shells.]
  21.  
  22. Please read the manual if you have never read the LS 4.5ljr manual.
  23. Please read the following if you have read the manual.
  24.  
  25. --
  26.  
  27. First release to be compiled with SAS/C v 6.0.  Smaller and
  28. Faster.  Way to go SAS! :-)
  29.  
  30. --
  31.  
  32. For me:
  33.  
  34. Fixed bug that caused any format not ending in '\n' to have an output
  35. problem!  Extra junk after some entries was being output.
  36.  
  37. --
  38.  
  39. Added for Dan:
  40.  
  41. \" is now a valid way to include a quote on the command line.  E.g.:
  42.  
  43. <some command> `ls -fHF "\"%n\" "`
  44.  
  45. will protect filenames with spaces in them.
  46.  
  47. --
  48.  
  49. For Dan:
  50.  
  51. Looked into problem related to removal of non-fixed disk while ls '-R' is
  52. scanning the media.  Basically ls puts up one requestor per subdirectory
  53. in the current scan directory and then quits.  Examine() / ExNext() appear
  54. to have some weirdness and don't respond with the correct error message.
  55. at least they don't set IoErr to the proper value under the OFS:
  56. IoErr() returns ERROR_NO_MORE_ENTRIES!  even if the scan is interrupted
  57. due to disk removal --- what the hell?  I'm leaving it alone.
  58.  
  59. Did fix one bug, ls wasn't actually checking IoErr() when ExNext()
  60. quit returning entries!
  61.  
  62. Fixed AsimCDFS CD-ROM file handler / ls interaction.  ls had a bug.  It
  63. didn't treat entries with non-listed filetype numbers as it should (I
  64. guess - things are a bit vague in this area, IMHO).  ls was just being
  65. stricter than it should have been.  Ls will now print any file entry with
  66. a negative (or =3) type number as a file.  It will still only recurse
  67. into directories (>=0 & !=3) if they have a C= listed number.
  68. In the long listing, s and S appear in the file type field in place
  69. of - and d if special files.
  70.  
  71. --
  72.  
  73. For Chris:
  74.  
  75.     [Filenote comments used to always come on the line following
  76.      the long listing entry for the file it referred to.]
  77.  
  78.     The placement and way filenotes are displayed can now be modified
  79.     by setting the ls_highlight0.on and ls_highlight0.off local
  80.     environment variables (see subsection entitled, ``Environment
  81.     variables'') and the format string (see subsection entitled,
  82.     ``Formatted Output'') and the 'w' string.  The default format
  83.     string is "%p %5b %8s %d %n%w%C\n".  The %C sequence is the place the
  84.     filenote will appear in the output if requested with the '-c' option.
  85.     If filenotes not requested or none present for a given file, %C
  86.     expands to 0 characters, even if the highlighting strings are set to
  87.     a displayable characters.
  88.  
  89.     '%w' is expanded to the current w (for whitespace? set via '-w' command
  90.     line switch, e.g. ls -c -w " " ram:) string if %C would expands
  91.     to a non-zero number of characters for the current entry.
  92.  
  93.     The %w string defaults to "\n".
  94.     ls_highlight0.on defaults to "\x9b" "2m/* " and ls_highlight0.off
  95.     defaults to " */\x9b" "22m".  Thus all filenotes will appear on the
  96.     line after the normal long listing entry in an alternate color in
  97.     a C-style comment.  E. g.
  98.  
  99.     R(0);T(00.266) > ls -c ram:a
  100.     -----rwed c     1        0 Sep 30 22:37 a
  101.     /* this file is neat */
  102.  
  103.     For example:
  104.     R(0);T(00.000) > set ls_highlight0.on " /** "
  105.     R(0);T(00.016) > set ls_highlight0.off " **/"
  106.     R(0);T(00.000) > ls -cw " " ram:a
  107.         -----rwed c     1        0 Sep 30 22:37 a /* this file is neat */
  108.  
  109.    BTW, %w and -w are a hack, pure and simple.
  110.  
  111. --
  112.  
  113. new formats for -F option argument:
  114.  
  115.     %C   Print filenote comment if present and requested with '-c'.
  116.          Filenote comment will have the highlight entry 0 applied to it
  117.          (see comments given in section describing '-c' option) before
  118.          printing.  In general, highlighting (ANSI color sequences, etc.)
  119.          should never be placed in the format string directly
  120.          as it will not be filtered out correctly when ls is given the
  121.          '-k' option or when ls is printing to a non-interactive device.
  122.          In %C's case, this is especially important and in fact nothing
  123.          related to filenote formatting should be included because not
  124.          all files have filenotes and in any event they are not always
  125.          printed.
  126.  
  127.    '%w'  is expanded to the current w (for whitespace? set via '-w' command
  128.          line switch, e.g. ls -c -w " " ram:) string if %C would expands
  129.          to a non-zero number of characters for the current entry.
  130.  
  131. --
  132.  
  133. New since 4.5ljr:
  134.  
  135. 4.6ljr was an internal version that only fixed the Flush() 'problem'.
  136. I've been meaning to release an update to ls for a long time...
  137. ...been busy with new job and...
  138. ...been waiting for SAS/C 6.0 offical release [couldn't release *anything*
  139. based on it until the offical release.]
  140.  
  141. --
  142.  
  143. For various people:
  144.  
  145. hack to Flush (Output ()) before ls terminates to allow some broken
  146. 3rd party shells to work with ls's use of 2.0's buffered IO.
  147.  
  148. --
  149.  
  150. For Dan:
  151.  
  152. changing the hide pattern:
  153.  
  154.     [NOTE: No support for changing how 'h' protection bit based
  155.      hiding works.  It really doesn't seem worth the effort... :-)
  156.      I don't have any '+h' protected files anyways.  And, excluding
  157.      files with other protection bit settings doesn't make a lot of
  158.      sense IMHO.]
  159.  
  160.     "(#?.(info|bak)|.#?)" is the default hide pattern.  This
  161.     can be changed by setting the ls_hidepattern local environment
  162.     variable (see subsection entitled, ``Environment variables'').
  163.     For example, the following issued in a shell (or added to a
  164.     shell-startup command file): set ls_hidepattern ".#?",
  165.     would cause Amiga ls to function as a normal unix ls.
  166.  
  167. --
  168.  
  169. update list of ls_highlight#'s:
  170.  
  171. With the advent of Amiga OS Release 2.04, there are now many more types of
  172. entries that can appear on a filing system (a disk).  A number is
  173. associated with each entry type, e.g.:
  174. -4     is associated with a FILE LINK (hard link)
  175. -3     " " " PLAIN FILE
  176. -2 - -1 " " " NOT USED CURRENTLY
  177. 0      " " " (hack to provide a space for) FILENOTE (related highlighing)
  178. 1      " " " ROOT
  179. 2      " " " USER DIR
  180. 3      " " " SYMBOLIC LINK (soft link)
  181. 4      " " " DIR LINK (hard link)
  182.  
  183. [the space for FILENOTE was always used this way, I just forgot to
  184. document this aspect in 4.5]
  185.  
  186. --
  187.  
  188. Regards,
  189. Loren
  190. rittle@comm.mot.com
  191.  
  192.  
  193. ============================= Archive contents =============================
  194.  
  195. Original  Packed Ratio    Date     Time    Name
  196. -------- ------- ----- --------- --------  -------------
  197.       33      33  0.0% 12-Jan-92 20:28:20  ls-4.7ljr/ALIASES/hexls
  198.      215     118 45.1% 12-Jan-92 21:42:44  ls-4.7ljr/ALIASES/timels
  199.    17982    6993 61.1% 30-Sep-92 23:08:30  ls-4.7ljr/COPYING
  200.      293     105 64.1% 12-Jan-92 21:52:22  ls-4.7ljr/HIGHLIGHT_SETS/colored_symbols
  201.      247      92 62.7% 12-Jan-92 21:51:40  ls-4.7ljr/HIGHLIGHT_SETS/symbols
  202.    12360    7715 37.5% 20-Nov-92 01:02:26  ls-4.7ljr/ls
  203.    12076    7542 37.5% 20-Nov-92 01:00:34  ls-4.7ljr/ls.030
  204.    37323   10737 71.2% 26-Oct-92 01:37:30  ls-4.7ljr/ls.c
  205.    23970    9744 59.3% 26-Oct-92 01:31:10  ls-4.7ljr/ls.doc
  206.      877     374 57.3% 29-Sep-92 23:34:16  ls-4.7ljr/ls.h
  207.     1587     718 54.7% 20-Nov-92 01:02:42  ls-4.7ljr/Makefile
  208.     6985    3165 54.6% 20-Nov-92 01:07:42  ls-4.7ljr/README
  209.      101      88 12.8% 02-Oct-92 00:07:26  ls-4.7ljr/REXX/date.rexx
  210.      157     120 23.5% 12-Jan-92 23:44:46  ls-4.7ljr/REXX/monthls.rexx
  211.       72      64 11.1% 02-Oct-92 00:03:42  ls-4.7ljr/REXX/sdate.rexx
  212.      141     112 20.5% 12-Jan-92 23:37:02  ls-4.7ljr/REXX/todayls.rexx
  213.      155     120 22.5% 12-Jan-92 23:43:40  ls-4.7ljr/REXX/weekls.rexx
  214. -------- ------- ----- --------- --------
  215.   114574   47840 58.2% 20-Nov-92 16:40:58   17 files
  216.